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Foreword 



id , 



This Technical Specification has been produced by the 3 Generation Partnership Project (3GPP). 

The contents of the present document are subject to continuing work within the TSG and may change following formal 
TSG approval. Should the TSG modify the contents of the present document, it will be re-released by the TSG with an 
identifying change of release date and an increase in version number as follows: 

Version x.y.z 

where: 

x the first digit: 

1 presented to TSG for information; 

2 presented to TSG for approval; 

3 or greater indicates TSG approved document under change control. 

y the second digit is incremented for all changes of substance, i.e. technical enhancements, corrections, 
updates, etc. 

z the third digit is incremented when editorial only changes have been incorporated in the document. 



Introduction 



rd , 



The present document is part of a TS-family covering the 3 Generation Partnership Project; Technical Specification 
Group Services and System Aspects; Telecommunication management; as identified below: 

32.3 1 1 : Generic Integration Reference Point (IRP) management; Requirements 

32.312: Generic Integration Reference Point (IRP) management; Information Service (IS) 

32.313: Generic Integration Reference Point (IRP) management; Common Object Request Broker 

Architecture (CORBA) Solution Set (SS) 

32.317: "Generic Integration Reference Point (IRP) management; Simple Object Access Protocol (SOAP) 

Solution Set (SS)" 
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Scope 



The present document specifies the CORBA Solution Set for Generic Integration Reference Point (IRP) management 
whose capabilities are specified in 3GPP TS 32.312 [1], the Generic IRP management: Information Service. 

This Solution Set specification is related to TS 32.312 V7.0.X. 



2 References 

The following documents contain provisions which, through reference in this text, constitute provisions of the present 
document. 

• References are either specific (identified by date of publication, edition number, version number, etc.) or 
non-specific. 

• For a specific reference, subsequent revisions do not apply. 

• For a non-specific reference, the latest version applies. In the case of a reference to a 3GPP document (including 
a GSM document), a non-specific reference implicitly refers to the latest version of that document in the same 
Release as the present document. 

[1] 3GPP TS 32.312: "Telecommunication management; Generic Integration Reference Point (IRP) 

management: Information Service (IS)". 

[2] 3GPP TS 32.31 1: "Telecommunication management; Generic Integration Reference Point (IRP) 

management; Requirements". 

[3] 3GPP TS 32.1 1 1-2: "Telecommunication management; Alarm Integration Reference Point (IRP); 

Information Service (IS)". 

[4] 3GPP TS 32.302: "Telecommunication management; Configuration Management (CM); 

Notification Integration Reference Point (IRP): Information Service (IS)". 



3 Definitions and abbreviations 

3.1 Definitions 

For the purposes of the present document, the terms and definitions given in TS 32.312 [1] apply. 
IRP document version number string (or "IRPVersion"): See 3GPP TS 32.31 1 [2] subclause 3.1. 

3.2 Abbreviations 

For the purposes of the present document, the following abbreviations apply: 

CORBA Common Object Request Broker Architecture 

IDL Interface Definition Language 

IRP Integration Reference Point 

IOC Information Object Class 

OMG Object Management Group 

SS Solution Set 
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4 Architectural Features 

The overall architectural feature of this IRP is specified in 3G TS 32.312 [1]. This clause specifies features that are 
specific to the CORBA SS. 

Abstract IOC 

The capabilities of the Generic IRP management: IS [1] are captured by the definition of an IOC called 
ManagedGenericIRP. This IOC is an abstract class and is mapped to a MOC of the same name. The MOC is intended 
for inheritance by other MOCs specified in Interface IRPs such as AlarmIRP [3], NotificationIRP [4], etc. 



5. Mapping 

5.1 Operation mapping 

Generic IRP management: IS [1] defines semantics of operation visible across the Itf-N. Table 1 indicates mapping of 
these operations to their equivalents defined in this SS. 

Table 5.1 : Mapping from IS Notification/Operation to SS equivalents 



IS Operation TS 32.312 [1] 


SS Method 


Qualifier 


getlRPVersion 


get irp versions 


M 


getOperationProfile 


get interface irp operation profile 


O 


getNotificationProfile 


get interface irp notification profile 


O 



5.2 Operation parameter mapping 



Generic IRP management: IS [1] defines semantics of parameters carried in operations across the Itf-N. The following 
set of tables indicates the mapping of these parameters, as per operation, to their equivalents defined in this SS. 

Table 5.2 Mapping from IS getlRPVersion parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


versionNumberSet 


Return value of type GenericlRPManagementConstDefs::VersionNumberSet 


M 


status 


Exceptions: 
GenericlRPManagementSystem::GetlRPVersions 


M 



Table 5.3 Mapping from IS getOperationProfile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs::VersionNumber 
this irp version 


M 


operationNameProfile, 
operationParameterProfile 


Return value of type 
GenericlRPManagementConstDefs::MethodList 


M 


status 


Exceptions: 

GenericlRPManagementSystem::GetlnterfacelRPOperationsProfile, 

GenericlRPManagementSystem::OperationNotSupported, 

GenericlRPManagementSystem::lnvalidParameter, 

GenericlRPManagementSystem::ValueNotSupported 


M 
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Table 5.4 Mapping from IS getNotif icationProf ile parameters to SS equivalents 



IS Operation parameter 


SS Method parameter 


Qualifier 


iRPVersion 


GenericlRPManagementConstDefs::VersionNumber this irp version 


M 


notificationNameProfile, 
notificationParameterProfile 


Return value of type 
GenericlRPManagementConstDefs::NotificationList 


M 


status 


Exceptions: 

GenericlRPManagementSystem::GetlnterfacelRPNotif icationProf ile, 
GenericlRPManagementSystem::OperationNotSupported, 
GenericlRPManagementSystem::lnvalidParameter, 
GenericlRPManagementSystem::ValueNotSupported 


M 
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Annex A (normative): 
IDL specifications 

A.1 IDL specification (file name 

'GenericlRPManagementConstDefs.idl') 

//File : GenericIRPManagementConstDef s . idl 

#ifndef _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 

#define _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 

#include <TimeBase . idl> 

// This statement must appear after all include statements 

#pragma prefix "3gppsa5.org" 

/* ## Module: GenericIRPManagementConstDef s 

This module contains definitions commonly used among all IRPs . 

*/ 

module GenericIRPManagementConstDef s 

{ 

/* 

* Definition imported from CosTime. 

* The time refers to time in Greenwich Time Zone. 

* It also consists of a time displacement factor in the form of minutes of 

* displacement from the Greenwich Meridian. 
*/ 

typedef TimeBase : :UtcT IRPTime; 

typedef string DN; 

typedef sequence <DN> DNList; 

enum Signal {OK, FULL_FAILURE, PARTIAL_FAILURE } ; 
enum Result {SUCCESS, FAILURE}; 
/* 

* This holds a list of notification Ids 
*/ 

typedef sequence <long> Not if IdSet; 

/* 

* This holds identifiers of notifications that are correlated. 

struct CorrelatedNotif i cat ion 
{ 

DN source;// Contains DN of MO that emitted the set of notifications 
// DN string format in compliance with Name Convention for 
// Managed Object. 

// This may be a zero-length string. In this case, the MO 
// is identified by the value of the MOI attribute 
// of the Structured Event, i.e., the notification. 
NotifldSet notif_id_set ; // Set of related notification ids 

}; 
/* 

* The VersionNumber is a string that identifies the IRP specification name 

* and its version number. See definition "IRP document version number 

* string" or "IRPVersion" . 

* The VersionNumberSet is a sequence of such VersionNumber. It is returned 

* by get_XXX_IRP_versions ( ) . The sequence order has no significance. 
*/ 

typedef string VersionNumber; 

typedef sequence <VersionNumber> VersionNumberSet; 
typedef string MethodName; 
typedef string ParameterName; 

typedef sequence <ParameterName> ParameterList; 
/* 

* The Method defines the structure to be returned as part of 

* get_supported_operations_prof ile ( ) . The name shall be the actual method 

* name (ex. "attach_push" , "change_subscription_f ilter" , etc.) 

* The parameter_list contains a list of strings. Each string shall be 

* the actual parameter name (ex. "manager_ref erence" , "filter", etc.) 
*/ 

struct Method 
{ 

MethodName name; 
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Parameter Li st parameter_list; 



* List of all methods and their associated parameters. 

*/ 

typedef sequence <Method> MethodList; 

typedef string Notif icationName; 

struct Notification 

{ 

Notif icationName name; 

Parameter List parameter_list ; 



typedef sequence <Notif ication> Notif icationList; 



/* 



Defines the name of an attribute of a Managed Object 



*/ 

typedef string MOAttributeName; 



/* 



/* 



/* 

* Defines the value of an attribute of a Managed Object in form of a CORBA 

* Any. Apart from basic datatypes already defined in CORBA, the allowed 

* attribute value types are defined in the AttributeTypes module. 
*/ 
typedef any MOAttributeValue; 

* Represents an attribute: "name" is the attribute name 

* and "value" is the attribute value. 
*/ 

struct MOAttribute 
{ 

MOAttributeName name; 
MOAttributeValue value; 

}; 

typedef sequence <MOAttribute> MOAttributeSet ; 

typedef string Managerldentif ier; 

* The following are types carrying an optional parameter. 

* If the boolean is TRUE, then the value is present. 

* Otherwise the value is absent. 
*/ 

union StringOpt switch (boolean) 

case TRUE: string value; 
union Short Opt switch (boolean) 

case TRUE: short value; 
union UnsignedShortOpt switch (boolean) 

case TRUE: unsigned short value; 
union LongOpt switch (boolean) 

case TRUE: long value; 
union UnsignedLongOpt switch (boolean) 

case TRUE: unsigned long value; 
union IRPTimeOpt switch (boolean) 

case TRUE: GenericIRPManagementConstDef s : : IRPTime value; 
#endif // _GENERIC_IRP_MANAGEMENT_CONST_DEFS_IDL_ 
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A.2 IDL specification (file name 

'GenericlRPManagementSystem.idr) 

//File : Generic I RPManagement System. idl 
#ifndef _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
#define _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 

#include <GenericIRPManagementConstDef s . idl> 

// This statement must appear after all include statements 
#pragma prefix "3gppsa5.org" 

module Gene ricIRPManagement System 
{ 

exception Getlnterf acelRPNotif icationProf ile { string reason; }; 

exception Getlnterf acelRPOperationProf ile { string reason; }; 

exception GetlRPVersions { string reason; }; 

/* 

Exception thrown when an unsupported optional parameter 

is passed with information. 

The parameter shall be the actual unsupported parameter name. 

*/ 

exception ParameterNotSupported { 

GenericIRPManagementConstDef s : :ParameterName parameter; }; 

/* 

Exception thrown when an invalid parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception InvalidParameter { 

GenericIRPManagementConstDef s : :ParameterName parameter; }; 

/* 

Exception thrown when a valid but unsupported parameter value is passed. 

The parameter shall be the actual parameter name. 

*/ 

exception ValueNotSupported { 

GenericIRPManagementConstDef s : :ParameterName parameter; }; 

/* 

Exception thrown when an unsupported optional method is called. 

*/ ' 

exception OperationNotSupported { } ; 

interface Generic IRP Management 
{ 

/* 

Return the list of all supported Interface IRP versions 

Each IRPVersion is defined by the rule in the definition 

"IRP document version number string" or "IRPVersion" 

(see subclause 3.1) . 

*/ 

GenericIRPManagementConstDef s : : VersionNumberSet get_irp_versions 

( 

) 

raises (GetlRPVersions) ; 

/* 

Return the list of all supported methods and their supported 

parameters for this Interface IRPVersion. 

*/ 

GenericIRPManagementConstDef s : :MethodList 

get__interf ace_irp_operation_prof ile 
( 

in GenericIRPManagementConstDef s : : VersionNumber this_irp_version 
) 
raises (Get Interf acelRPOperationProf ile, 

OperationNotSupported, 

InvalidParameter, 

ValueNotSupported) ; 

/* 

Return the list of all supported notifications and their supported 
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parameters for this Interface IRPVersion. 

*/ 

typedef GenericIRPManagementConstDef s : :Notif icationList Notif icationList; 

NotificationList get_interf ace_irp_notif ication_prof ile 
( 

in GenericIRPManagementConstDef s : : VersionNumber this_irp_version 
) 
raises (Get Inter face IRPNot if icationProf ile, 

OperationNot Supported, 

InvalidParameter, 

ValueNotSupported) ; 

}; 

}; 

#endif // _GENERIC_IRP_MANAGEMENT_SYSTEM_IDL_ 
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Annex B (informative); 
Change history 



Change history 


Date 


TSG# 


TSG Doc. 


CR 


Rev 


Subject/Comment 


Cat 


Old 


New 


Dec 2004 


S 26 


SP-040795 


-- 


-- 


Submitted to SA#26 for Approval 


-- 


1.0.0 


6.0.0 


Jun 2005 


S_28 


SP-050288 


0001 


— 


Correction of IDL syntax errors in 
GenericlRPManagement{ConstDefs|System}.idl 


F 


6.0.0 


6.1.0 


Sep 2005 


SA 29 


SP-050461 


0002 


-- 


Align the CORBA SS IDL with TS 32.1 50 Style Guide 


F 


6.1.0 


6.2.0 


Sep 2006 


SA 33 


SP-060529 


0003 


-- 


Capture all CORBA common types in 32.313 


F 


6.2.0 


6.3.0 


Mar 2007 


SA 35 


SP-070035 


0004 


-- 


Correct the compiling errors in the CORBA IDL 


F 


6.3.0 


6.4.0 


Jun 2007 


SA 36 


- 


-- 


- 


Automatic upgrade to Rel-7 (no CR) at freeze of Rel-7. Deleted reference 
to CMIP SS, discontinued from R7 onwards. 


- 


6.4.0 


7.0.0 
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